OLA 文档中心

主题

2026-07-14

激活 - Activate ​

函数简介 ​

使用激活码激活软件，完成授权激活。激活码在欧拉后台生成

返回数据格式：

json
{
  "EndTime": "2026-03-01 11:40:41.193",
  "LicenseType": 3,
  "LicenseTypeStr": "月卡",
  "Message": "",
  "RemainingCount": 0,
  "ServerTime": "2025-12-30 11:40:41.132",
  "Status": 0,
}
字段名说明
EndTime授权到期时间。
LicenseType授权类型：0次卡，1小时卡，2日卡，3月卡，4年卡，5永久卡。
LicenseTypeStr授权类型描述。
Message提示信息；失败时多为 错误码:中文描述（如 "2003:参数无效"），也可直接展示给用户。完整对照见 客户端错误码说明。
RemainingCount次卡剩余次数。
ServerTime服务器时间。
Status激活状态：1成功，0失败。

常见错误码（Message 字段） ​

格式：{错误码}:{中文描述}。

Message含义
2002:用户码无效用户码无效
2003:参数无效入参校验失败
2004:用户不存在用户不存在
2005:软件不可用或未开通SoftCode 无效或未开通
2008:授权无效激活后授权状态异常
2011:次卡功能已隐藏次卡类型不再对客户端开放
2014:永久卡无法续费设备已有有效永久授权
2099:…激活失败（冒号后可能为下游具体原因）

接口名称 ​

Activate

DLL调用 ​

long Activate(string userCode, string softCode, string softVersion, string dealerCode, string licenseKey);

参数说明 ​

参数名类型说明
userCode字符串用户码。
softCode字符串软件码。
softVersion字符串软件版本。(用于区分你自己的软件版本信息,未来可用于版本控制,可空)。
dealerCode字符串经销商码。(用于区分你自己的经销商信息,未来可用于版本控制,可空)。
licenseKey字符串激活码。

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
OlaAuthActivateReturn result = ola.Activate("userCode", "softCode", "1.0.0", "dealerCode", "DK-XXXX-XXXX");
// result.Status == 1 表示激活成功
csharp
using OLAPlug;

var ola = new OLAPlugServer();
OlaAuthActivateReturn result = ola.Activate("userCode", "softCode", "1.0.0", "dealerCode", "DK-XXXX-XXXX");
// result.Status == 1 表示激活成功
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
json_result = ola.Activate("userCode", "softCode", "1.0.0", "dealerCode", "DK-XXXX-XXXX")
# Python SDK 返回 JSON 字符串，需自行解析
java
import com.olaplug.OLAPlugServer;
import com.olaplug.model.OlaAuthActivateReturn;

OLAPlugServer ola = new OLAPlugServer();
OlaAuthActivateReturn result = ola.Activate("userCode", "softCode", "1.0.0", "dealerCode", "DK-XXXX-XXXX");
// result.Status == 1 表示激活成功
go
import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
result := ola.Activate("userCode", "softCode", "1.0.0", "dealerCode", "DK-XXXX-XXXX")
// result.Status == 1 表示激活成功
rust
use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let result = ola.activate("userCode", "softCode", "1.0.0", "dealerCode", "DK-XXXX-XXXX");
// result.status == 1 表示激活成功
cpp
var ola = com("OlaPlug.OlaSoft")
var result = ola.Activate("userCode", "softCode", "1.0.0", "dealerCode", "DK-XXXX-XXXX")
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
Set result = ola.Activate("userCode", "softCode", "1.0.0", "dealerCode", "DK-XXXX-XXXX")
text
.局部变量 ola, OLAPlug
.局部变量 result, OlaAuthActivateReturn
ola.创建 ()
result ＝ ola.Activate(“userCode”, “softCode”, “1.0.0”, “dealerCode”, “DK-XXXX-XXXX”)
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var json = ola.Activate("userCode", "softCode", "1.0.0", "dealerCode", "DK-XXXX-XXXX");
// Aardio SDK 返回 JSON 字符串，需自行解析
text
变量 ola <类型 = OLAPlugServer>
变量 result <类型 = OlaAuthActivateReturn>
ola = 新建 OLAPlugServer
result = ola.Activate("userCode", "softCode", "1.0.0", "dealerCode", "DK-XXXX-XXXX")
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
OlaAuthActivateReturn result = ola.Activate("userCode", "softCode", "1.0.0", "dealerCode", "DK-XXXX-XXXX");
// result.Status == 1 表示激活成功

原生 DLL 调用 ​

cpp
Activate(instance, "userCode", "softCode", "1.0.0", "dealerCode", "DK-XXXX-XXXX");
csharp
using System.Runtime.InteropServices;
using System.Text;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long Activate(string userCode, string softCode, string softVersion, string dealerCode, string licenseKey);

Activate(instance, "userCode", "softCode", "1.0.0", "dealerCode", "DK-XXXX-XXXX");
python
from ctypes import CDLL, c_int, c_int64, create_string_buffer

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
ola.Activate(instance, "userCode", "softCode", "1.0.0", "dealerCode", "DK-XXXX-XXXX")

返回值 ​

调用方式返回值说明
SDKOlaAuthActivateReturn结构化返回对象；Status == 1 表示激活成功
原生 DLL非 0成功，返回 JSON 字符串格式的结果。
原生 DLL0失败。

注意事项 ​

项目说明
释放内存返回的字符串指针需要调用 FreeStringPtr 接口释放内存。
激活码需要从授权平台获取激活码需要从授权平台获取，每个激活码通常只能使用一次。
用户码、软件码和经销商码需要与申请激活码时的信息用户码、软件码和经销商码需要与申请激活码时的信息保持一致。
错误提示本接口业务失败 Message 为 错误码:中文描述；完整码表见 客户端错误码说明。